home *** CD-ROM | disk | FTP | other *** search
/ Meeting Pearls 1 / Meeting Pearls Vol 1 (1994).iso / installed_progs / text / faqs / aix-faq.part3 < prev    next >
Encoding:
Internet Message Format  |  1994-05-08  |  56.7 KB

  1. Subject: AIX Frequently Asked Questions (Part 3 of 3)
  2. Newsgroups: comp.unix.aix,comp.answers,news.answers
  3. From: jwarring@fmsaix.amsinc.com (Jeff Warrington)
  4. Date: 06 May 1994 23:48:54 GMT
  5.  
  6. Archive-name: aix-faq/part3
  7. Last-modified: May 6, 1994
  8. Version: 3.10
  9.  
  10.  
  11. Version: $Id: faq.3,v 1.2 1994/05/06 23:28:30 jwarring Exp $
  12.  
  13. Frequently Asked Questions to AIX 3.x and IBM RS/6000
  14. _____________________________________________________
  15.  
  16. 2.04: How do I link my program with a non-shared /lib/libc.a?
  17.  
  18.   cc -o prog -bnoso -bI:/lib/syscalls.exp obj1.o obj2.o obj3.o
  19.  
  20. will do that for a program consisting of the three objects obj1.o, etc.
  21.  
  22. From: Marc Pawliger (marc@sti.com)
  23.  
  24. As of AIX 3.2.5, you can install a speedup for AIXwindows called
  25. Shared Memory Transport.  To static link an X application after the
  26. SMT PTF has been installed, you must link with
  27. -bI:/usr/lpp/X11/bin/smt.exp and the executable will NOT run on a
  28. machine where SMT is not installed.  See /usr/lpp/X11/README.SMT
  29.  
  30. 2.05: How do I make my own shared library?
  31.  
  32. To make your own shared object or library of shared objects, you should
  33. know that a shared object cannot have undefined symbols.  Thus, if your
  34. code uses any externals from /lib/libc.a, the latter MUST be linked with
  35. your code to make a shared object.  Mike Heath (mike@pencom.com) said it
  36. is possible to split code into more than one shared object when externals
  37. in one object refer to another one.  You must be very good at
  38. import/export files.  Perhaps he or someone can provide an example. 
  39.  
  40. Assume you have one file, sub1.c, containing a routine with no external
  41. references, and another one, sub2.c, calling stuff in /lib/libc.a.  You
  42. will also need two export files, sub1.exp, sub2.exp.  Read the example
  43. below together with the examples on the ld man page. 
  44.  
  45. ---- sub1.c ----
  46.     int addint(int a, int b)
  47.     {
  48.       return a + b;
  49.     }
  50. ---- sub2.c ----
  51.     #include <stdio.h>
  52.  
  53.     void printint(int a)
  54.     {
  55.       printf("The integer is: %d\n", a);
  56.     }
  57. ---- sub1.exp ----
  58.     #!
  59.     addint
  60. ---- sub2.exp ----
  61.     #!
  62.     printint
  63. ---- usesub.c ----
  64.     main()
  65.     {
  66.       printint( addint(5,8) );
  67.     }
  68.  
  69. The following commands will build your libshr.a, and compile/link the
  70. program usesub to use it.  Note that you need the ld option -lc for
  71. sub2shr.o since it calls printf from /lib/libc.a.
  72.  
  73.   $ cc  -c sub1.c
  74.   $ ld -o sub1shr.o sub1.o -bE:sub1.exp -bM:SRE -T512 -H512 
  75.   $ cc  -c sub2.c
  76.   $ ld -o sub2shr.o sub2.o -bE:sub2.exp -bM:SRE -T512 -H512  -lc
  77.   $ ar r libshr.a sub1shr.o sub2shr.o
  78.   $ cc -o usesub usesub.c -L: libshr.a
  79.   $ usesub
  80.   The integer is: 13
  81.   $
  82.  
  83.  
  84. 2.06: Linking my program fails with strange errors.  Why?
  85.  
  86. Very simple, the linker (actually called the binder), cannot get the
  87. memory it needs, either because your ulimits are too low or because you
  88. don't have sufficient paging space.  Since the linker is quite different
  89. >from normal Unix linkers and actually does much more than these, it also
  90. uses a lot of virtual memory.  It is not unusual to need 10000 pages (of
  91. 4k) or more to execute a fairly complex linking.
  92.  
  93. If you get 'BUMP error', either ulimits or paging is too low, if you get
  94. 'Binder killed by signal 9' your paging is too low.
  95.  
  96. First, check your memory and data ulimits; in korn shell 'ulimit -a' will
  97. show all limits and 'ulimit -m 99999' and 'ulimit -d 99999' will
  98. increase the maximum memory and data respectively to some high values. 
  99. If this was not your problem, you don't have enough paging space.
  100.  
  101. If you will or can not increase your paging space, you could try this:
  102.  
  103. - Do you duplicate libraries on the ld command line? That is never
  104.   necessary.
  105.  
  106. - Do more users link simultaneously? Try having only one linking going
  107.   on at any time.
  108.  
  109. - Do a partwise linking, i.e. you link some objects/libraries with the
  110.   -r option to allow the temporary output to have unresolved references,
  111.   then link with the rest of your objects/libraries.  This can be split
  112.   up as much as you want, and will make each step use less virtual memory.
  113.  
  114.   If you follow this scheme, only adding one object or archive at a
  115.   time, you will actually emulate the behavior of other Unix linkers.
  116.  
  117. If you decide to add more paging space, you should consider adding a new
  118. paging space on a second hard disk, as opposed to just increasing the
  119. existing one.  Doing the latter could make you run out of free space on
  120. your first harddisk. It is more involved to shrink a paging space
  121. but easier to delete one.
  122.  
  123.  
  124. 2.07: What's with malloc()?
  125.  
  126. malloc() uses a late allocation algorithm based on 4.3 BSD's malloc()
  127. for speed.  This lets you allocate very large sparse memory spaces,
  128. since the pages are not actually allocated until they are touched for
  129. the first time.  Unfortunately, it doesn't die gracefully in the face of
  130. loss of available memory.  See the "Paging Space Overview" under
  131. InfoExplorer, and see the notes on the linker in this document for an
  132. example of an ungraceful death.
  133.  
  134. If you want your program to get notified when running out of memory, you
  135. should handle the SIGDANGER signal.  The default is to ignore it. 
  136. SIGDANGER is sent to all processes when paging space gets low, and if
  137. paging space gets even lower, processes with the highest paging space
  138. usage are sent the SIGKILL signal.
  139.  
  140. malloc() is substantially different in 3.2, allocating memory more
  141. tightly.  If you have problems running re-compiled programs on 3.2, try
  142. running them with MALLOCTYPE=3.1. 
  143.  
  144. Early Page Space Allocation (EPSA) added to AIX 3.2: see
  145. /usr/lpp/bos/README.PSALLOC - IX38211 / U422496 Allows setting of
  146. early allocation (vs. default late allocation) on a per-process basis.
  147.  
  148. 2.08: Why does xlc complain about 'extern char *strcpy()'
  149.  
  150. The header <string.h> has a strcpy macro that expands strcpy(x,y) to
  151. __strcpy(x,y), and the latter is then used by the compiler to generate
  152. inline code for strcpy.  Because of the macro, your extern declaration
  153. contains an invalid macro expansion.  The real cure is to remove your
  154. extern declaration but adding -U__STR__ to your xlc will also do the trick.
  155.  
  156.  
  157. 2.09: Why do I get 'Parameter list cannot contain fewer ....'
  158.  
  159. This is the same as above.
  160.  
  161.  
  162. 2.10: Why does xlc complain about '(sometype *)somepointer = something'
  163.  
  164. Software that is developed using gcc may have this construct. However,
  165. standard C does not permit casts to be lvalues, so you will need to
  166. change the cast and move it to the right side of the assignment. If you
  167. compile with 'cc', removing the cast completely will give you a warning,
  168. 'xlc' will give you an error (provided somepointer and something are of
  169. different types - but else, why would the cast be there in the first place?)
  170.  
  171.  
  172. 2.11: Some more common errors
  173.  
  174. Here are a few other common errors with xlc:
  175.  
  176. 305 |     switch((((np)->navigation_type) ? (*((np)->navigation_type)) :
  177.       ((void *)0)))
  178.       .a...........  
  179. a - 1506-226: (S) The second and third operands of the conditional
  180. operator must be of the same type.
  181.  
  182. The reason for this is that xlc defines NULL as (void *)0, and it does
  183. not allow two different types as the second and third operand of ?:. 
  184. The second argument above is not a pointer and the code used NULL
  185. incorrectly as a scalar. NULL is a nil pointer constant in ANSI C and
  186. in some traditional compilers.
  187.  
  188. You should change NULL in the third argument above to an integer 0.
  189.  
  190.  
  191. 2.12: Can the compiler generate assembler code?
  192.  
  193. Starting with version 1.3 of xlc and xlf the -S option will generate a
  194. .s assembly code file prior to optimization. The option -qlist will
  195. generate a human readable one in a .lst file.
  196.  
  197. There is also a disassembler in /usr/lpp/xlc/bin/dis include with the
  198. 1.3 version of xlc (and in /usr/lpp/xlC/bin/dis with the 2.1 version
  199. of xlC) that will disassemble existing object or executable files.
  200.  
  201.  
  202. 2.13: Curses
  203.  
  204. Curses based applications should be linked with -lcurses and _not_ with
  205. -ltermlib. It has also been reported that some problems with curses are
  206. avoided if your application is compiled with -DNLS.
  207.  
  208. Peter Jeffe <peter@ski.austin.ibm.com> also notes:
  209.  
  210. >the escape sequences for cursor and function keys are *sometimes*
  211. >treated as several characters: eg. the getch() - call does not return
  212. >KEY_UP but 'ESC [ C.'
  213.  
  214. You're correct in your analysis: this has to do with the timing of the
  215. escape sequence as it arrives from the net. There is an environment
  216. variable called ESCDELAY that can change the fudge factor used to decide
  217. when an escape is just an escape. The default value is 500; boosting
  218. this a bit should solve your problems.
  219.  
  220. Christopher Carlyle O'Callaghan <asdfjkl@wam.umd.edu> has more comments
  221. concerning extended curses:
  222.  
  223. 1) The sample program in User Interface Programming Concepts, page 7-13
  224.    is WRONG. Here is the correct use of panes and panels.
  225.  
  226. #include <cur01.h>
  227. #include <cur05.h>
  228.  
  229. main()
  230. {
  231. PANE *A, *B, *C, *D, *E, *F, *G, *H;
  232. PANEL *P;
  233.  
  234. initscr();
  235.  
  236. A = ecbpns (24, 79, NULL, NULL, 0, 2500, Pdivszp, Pbordry, NULL, NULL);
  237. D = ecbpns (24, 79, NULL, NULL, 0, 0,    Pdivszf, Pbordry, NULL, NULL);
  238. E = ecbpns (24, 79, D,    NULL, 0, 0,    Pdivszf, Pbordry, NULL, NULL);
  239. B = ecbpns (24, 79, A, D, Pdivtyh, 3000, Pdivszp, Pbordry, NULL, NULL);
  240. F = ecbpns (24, 79, NULL, NULL, 0, 0,    Pdivszf, Pbordry, NULL, NULL);
  241. G = ecbpns (24, 79, F,    NULL, 0, 5000, Pdivszp, Pbordry, NULL, NULL);
  242. H = ecbpns (24, 79, G,    NULL, 0, 3000, Pdivszp, Pbordry, NULL, NULL);
  243. C = ecbpns (24, 79, B, F, Pdivtyh, 0, Pdivszf, Pbordry, NULL, NULL);
  244. P = ecbpls (24, 79, 0, 0, "MAIN PANEL", Pdivtyv, Pbordry, A);
  245.  
  246. ecdvpl (P);
  247. ecdfpl (P, FALSE);
  248. ecshpl (P); 
  249. ecrfpl (P);
  250. endwin();
  251. }
  252.  
  253. 2) DO NOT include <curses.h> and any other <cur0x.h> file together.
  254.    You will get a bunch of redefined statements.
  255.  
  256. 3) There is CURSES and EXTENDED CURSES. Use only one or the other. If the
  257.    manual says that they're backwards compatible or some other indication 
  258.    that you can use CURSES routines with EXTENDED, don't believe it. To 
  259.    use CURSES you need to include <curses.h> and you can't (see above).
  260.  
  261. 4) If you use -lcur and -lcurses in the same link command, you will get
  262.    Memory fault (core dump) error. You CANNOT use both of them at the same
  263.    time. -lcur is for extended curses, -lcurses is for regular curses.
  264.  
  265. 5) When creating PANEs, when you supply a value (other than 0) for the
  266.    'ds' parameter and use Pdivszf value for the 'du' parameter, the 'ds'
  267.    will be ignored (the sample program on page 7-13 in User Interface
  268.    Programming Concepts is wrong.) For reasons as yet undetermined,
  269.    Pdivszc doesn't seem to work (or at least I can't figure out how to
  270.    use it.)
  271.  
  272. 6) If you're running into bugs and can't figure out what is happening,
  273.    try the following:
  274.    include -qextchk -g in your compile line
  275.     -qextchk will check to make sure you're passing the right number of
  276.        parameters to the functions
  277.     -g enables debug
  278.  
  279. 7) Do not use 80 as the number of columns if you want to use the whole
  280.    screen. The lower right corner will get erased.  Use 79 instead.
  281.  
  282. 8) If you create a panel, you must create at least 1 pane, otherwise you
  283.    will get a Memory fault (core dump).
  284.  
  285. 9) When creating a panel, if you don't have a border around it, any title
  286.    you want will not show up.
  287.  
  288. 10) to make the screen scroll down:
  289.     wmove (win, 0, 0);
  290.     winsertln (win)
  291.  
  292. 11) delwin(win) doesn't work in EXTENDED WINDOWS
  293.  
  294.     To make it appear as if a window is deleted, you need to do the following:
  295.     for every window that you want to appear on the screen
  296.     touchwin(win)
  297.     wrefresh(win)
  298.  
  299.     you must make sure that you do it in the exact same order as you put
  300.     them on the screen (i.e., if you called newwin with A, then C, then B,
  301.     then you must do the loop with A, then C, then B, otherwise you won't
  302.     get the same screen back).  The best thing to do is to put them into
  303.     an array and keep track of the last window index.
  304.  
  305. 12) mvwin(win, line, col) implies that it is only used for viewports and
  306.     subwindows. It can also be used for the actual windows themselves.
  307.  
  308. 13) If you specify the attribute of a window using wcolorout(win), any
  309.     subsequent calls to chgat(numchars, mode) or any of its relatives
  310.     will not work. (or at least they get very picky.)
  311.  
  312.  
  313. 2.14: How do I speed up linking
  314.  
  315. Please refer to sections 2.03 and 2.06 above.
  316.  
  317. From: losecco@undpdk.hep.nd.edu (John LoSecco) and
  318.       hook@chaco.aix.dfw.ibm.com (Gary R. Hook)
  319.  
  320. >From oahu.cern.ch in /pub/aix3 you can get a wrapper for the existing
  321. linker called tld which can reduce link times with large libraries by
  322. factors of 3 to 4.
  323.  
  324.  
  325. 2.15: What is deadbeef?
  326.  
  327. When running the debugger (dbx), you may have wondered what the
  328. 'deadbeef' is you occasionally see in registers.  Do note, that
  329. 0xdeadbeef is a hexadecimal number that also happens to be some kind
  330. of word (the RS/6000 was built in Texas!), and this hexadecimal number
  331. is simply put into unused registers at some time, probably during
  332. program startup.
  333.  
  334.  
  335. 2.16: How do I statically link in 3.2?
  336.  
  337. xlc -bnso -bI:/lib/syscalls.exp -liconv -bnodelcsect 
  338.  
  339.  
  340. 2.17: How do I make an export list from a library archive?
  341. From: dad@adonis.az05.bull.com (Dave Dennerline)
  342.  
  343. This script will only extract the "export"able names and should be
  344. useful in starting the shared library creation process. The user must
  345. determine which names should be included in the import and export lists.
  346. It's only been tested on a few library archives.
  347.  
  348. #!/bin/ksh
  349. #
  350. # mkexps - make export list
  351. # This program creates an export list by combining all the "." and normal names
  352. # into one list. 
  353. #
  354. if [[ "$#" -ne 1 ]]
  355. then
  356.     print "Usage: mkexps ArchiveFile"
  357.     exit -2
  358. fi
  359. if [[ ! -f $1 ]] 
  360. then
  361.     print "mkexps: Cannot open file \"$1\""
  362.     exit -1
  363. fi
  364. dump -g $1 | awk '
  365. BEGIN {
  366.         top = 1
  367. }    
  368. /^[ ]*[0-9][0-9]*/ {
  369.     if ( (n = index( $2, "." )) > 0 ) {
  370.         export_array[ top++ ] = substr( $2, n+1, length( $2 ))
  371.     }
  372.     else {
  373.     export_array[ top++ ] = $2
  374.     }
  375. }
  376.  
  377. END {
  378.     for ( i = 1; i < top; i++ )
  379.     {
  380.     print export_array[ i ]
  381.     }
  382.  
  383. }' | sort | uniq
  384.  
  385. _____________________________________________________
  386. 3.00: Fortran and other compilers
  387.  
  388. This section covers all compilers other than C/C++.  On Fortran, there
  389. seem to have been some problems with floating point handling, in
  390. particular floating exceptions.
  391.  
  392.  
  393. 3.01: I have problems mixing Fortran and C code, why?
  394.  
  395. A few routines (such as getenv, signal, and system) exist in both the
  396. Fortran and C libraries but with different parameters. In the recent
  397. past, if you have a mixed program that calls getenv from both C and
  398. Fortran code, you have to link them carefully by specifying the correct
  399. library first on your command line. This is no longer needed starting
  400. with version 1.5 of the compilers.
  401.  
  402.  
  403. 3.02: How do I statically bind Fortran libraries and dynamically
  404.       bind C libraries?
  405. From: amaranth@vela.acs.oakland.edu (Paul Amaranth)
  406.  
  407. [ Editor's note: Part of this is also discussed above under the C compiler
  408.   section, but I felt it was so valuable that I have left it all in. 
  409.   I've done some minor editing, mostly typographical. ]
  410.  
  411. The linker and binder are rather versatile programs, but it is not
  412. always clear how to make them do what you want them to.  In particular,
  413. there are times when you do not want to use shared libraries, but
  414. rather, staticly bind the required routines into your object.  Or, you
  415. may need to use two versions of the same routine (eg, Fortran & C).  Here
  416. are the results of my recent experiments.  I would like to thank Daniel
  417. Premer and Brad Hollowbush, my SE, for hints.  Any mistakes or omissions
  418. are my own and I have tended to interchange the terms "linker" and
  419. "binder".  These experiments were performed on AIX 3.1.2.  Most of this
  420. should be applicable to later upgrades of 3.1.
  421.  
  422. 1)  I have some C programs, I want to bind in the runtime routines.  How
  423.     do I do this? [Mentioned in section 2.04 of this article as well, ed.]
  424.  
  425.     You can put the -bnso binder command on the link line.  You should
  426.     also include the -bI:/lib/syscalls.exp control argument:
  427.       
  428.       $ cc *.o -bnso -bI:/lib/syscalls.exp -o foo
  429.  
  430.     This will magically do everything you need.  Note that this will bind
  431.     _all_ required routines in.  The -bI argument tells the linker that
  432.     these entry points will be resolved dynamically at runtime (these are
  433.     system calls).  If you omit this you will get lots of unresolved 
  434.     reference messages.
  435.  
  436. 2)  I want to statically bind in the Fortran runtime so a) my customers 
  437.     do not need to buy it and b) I don't have to worry about the runtime
  438.     changing on a new release.  Can I use the two binder arguments in
  439.     1) to do this?
  440.  
  441.     You should be able to do so, but, at least under 3002, if you do
  442.     you will get a linker error referencing getenv.  In addition, there
  443.     are a number of potential conflicts between Fortran and C routines.
  444.     The easy way just does not work.  See the section on
  445.     2 stage linking for C and Fortran on how to do this.  The getenv
  446.     problem is a mess, see the section on Comments & Caveats for more.
  447.  
  448. 3)  I have a mixture of C and Fortran routines, how can I make sure
  449.     that the C routines reference the C getenv, while the Fortran routines
  450.     reference the Fortran getenv (which has different parameters and, if
  451.     called mistakenly by a C routine results in a segmentation fault)?
  452.  
  453.     From Mike Heath (mike@pencom.com):
  454.  
  455.     Use -brename:symbol1,symbol2 when pre-linking the modules from one
  456.     of the languages. It does not matter which one you choose.
  457.  
  458. 4)  I have C and Fortran routines.  I want to bind in the xlf library, while
  459.     letting the rest of the libraries be shared.  How do I do this?
  460.  
  461.     You need to do a 2 stage link.  In the first stage, you bind in the
  462.     xlf library routines, creating an intermediate object file.  The
  463.     second stage resolves the remaining references to the shared libraries.
  464.  
  465.     This is a general technique that allows you to bind in specific system
  466.     routines, while still referencing the standard shared libraries.
  467.  
  468.     Specifically, use this command to bind the xlf libraries to the Fortran
  469.     objects:
  470.  
  471.        $ ld -bh:4 -T512 -H512 <your objects> -o intermediat.o \
  472.          -bnso -bI:/lib/syscalls.exp -berok -lxlf -bexport:/usr/lib/libg.exp \
  473.          -lg -bexport:<your export file>
  474.  
  475.     The argument -bexport:<your export file> specifies a file with the
  476.     name of all entry points that are to be visible outside the intermediate 
  477.     module.  Put one entrypoint name on a line.  The -bI:/lib/libg.exp line 
  478.     is required for proper functioning of the program.  The -berok argument 
  479.     tells the binder that it is ok to have unresolved references, at least 
  480.     at this time (you would think -r would work here, but it doesn't seem to).  
  481.     The -bnso argument causes the required modules to be imported
  482.     into the object.  The -lxlf, of course, is the xlf library.
  483.  
  484.     Then, bind the intermediate object with the other shared libraries in
  485.     the normal fashion:
  486.  
  487.        $ ld -bh:4 -T512 -H512 <C or other modules> intermediate.o \
  488.          /lib/crt0.o -lm -lc
  489.  
  490.     Note the absence of -berok.  After this link, all references should
  491.     be resolved (unless you're doing a multistage link and making another
  492.     intermediate).
  493.  
  494.     NOTE THE ORDER OF MODULES.  This is extremely important if, for example,
  495.     you had a subroutine named "load" in your Fortran stuff.  Putting the
  496.     C libraries before the intermediate module would make the C "load"
  497.     the operable definition, rather than the Fortran version EVEN THOUGH 
  498.     THE FORTRAN MODULE HAS ALREADY BEEN THROUGH A LINK AND ALL REFERENCES 
  499.     TO THE SYMBOL ARE CONTAINED IN THE FORTRAN MODULE.  This can
  500.     be extremely difficult to find (trust me on this one :-)  Is this
  501.     a bug, a feature, or what?
  502.     
  503.     [As mentioned in section 2.03 of this article, it is a feature that you
  504.     can replace individual objects in linked files, ed.]
  505.  
  506.     The result will be a slightly larger object than normal.  (I say slightly
  507.     because mine went up 5%, but then it's a 2 MB object :-)
  508.  
  509.  
  510. Comments & Caveats:
  511.  
  512.    From the documentation the -r argument to the linker should do what
  513.    -berok does.  It does not.  Very strange results come from using the
  514.    -r argument.  I have not been able to make -r work in a sensible manner
  515.    (even for intermediate links which is what it is supposed to be for).
  516.  
  517.        Note from Mike Heath (mike@pencom.com):
  518.  
  519.        'ld -r' is essentially shorthand for 'ld -berok -bnogc -bnoglink'.
  520.        Certainly, using -berok with an export file (so garbage collection
  521.        can be done) is preferable to ld -r, but the latter is easier.
  522.  
  523.    When binding an intermediate module, use an export file to define the
  524.    entry points you want visible in the later link.  If you don't do this,
  525.    you'll get the dreaded "unresolved reference" error.  Import files name
  526.    entry points that will be dynamically resolved (and possibly where).
  527.  
  528.    If you are in doubt about what parameters or libraries to link, use the
  529.    -v arg when linking and modify the exec call that shows up into 
  530.    an ld command.  Some thought about the libraries will usually yield an
  531.    idea of when to use what.  If you don't know what an argument is for,
  532.    leave it in.  It's there for a purpose (even if you don't understand it).
  533.  
  534.    Watch the order of external definitions (ie, libraries) when more than
  535.    one version of a routine may show up, eg "load".  The first one defined
  536.    on the ld command line is the winner.  
  537.  
  538.    The getenv (and system and signal) problem is a problem that started out
  539.    minor, got somewhat worse in 3003 and, eventually will be correctly fixed.
  540.    Basically, you should extract the 3002 version of these three routines
  541.    from xlf.a before doing the update and save them away, then link these
  542.    routines in if you use these Fortran system services.  
  543.  
  544.  
  545. 3.03: How do I check if a number is NaN?
  546. From: sdl@glasnost.austin.ibm.com (Stephen Linam)
  547.  
  548. NaN is "Not a Number".  It arises because the RISC System/6000 uses
  549. IEEE floating point arithmetic.
  550.  
  551. To determine if a variable is a NaN you can make use of the property
  552. that a NaN does not compare equal to anything, including itself.
  553. Thus, for real variable X, use
  554.  
  555.     IF (X .NE. X) THEN    ! this will be true if X is NaN
  556.  
  557. Floating point operations which cause exceptions (such as an overflow)
  558. cause status bits to be set in the Floating Point Status and Control
  559. Register (FPSCR).  There is a Fortran interface to query the FPSCR, and
  560. it is described in the XLF Fortran manuals -- I don't have the manuals
  561. right here, but look for FPGETS and FPSETS.
  562.  
  563. The IBM manual "Risc System/6000 Hardware Technical Reference - General
  564. Information" (SA23-2643) describes what floating point exceptions can
  565. occur and which bits are set in the FPSCR as a result of those exceptions.
  566.  
  567.  
  568. 3.04: Some info sources on IEEE floating point
  569.  
  570. 1. ANSI/IEEE STD 754-1985 (IEEE Standard for Binary Floating-Point
  571.    Arithmetic) and ANSI/IEEE STD 854-1987 (IEEE Standard for
  572.    Radix-Independent Floating-Point Arithmetic), both available from IEEE. 
  573.  
  574. 2. David Goldberg, "What Every Computer Scientist Should Know About
  575.    Floating-Point Arithmetic", ACM Computing Surveys, Vol. 23, No. 1,
  576.    March 1991, pp. 5-48.
  577.  
  578. ____________________________________________________________________________
  579. 4.00: GNU and Public Domain software
  580.  
  581. GNU software comes from the Free Software Foundation and various other
  582. sources. A number of ftp sites archive them. Read the GNU license for 
  583. rules on distributing their software.
  584.  
  585. Lots of useful public domain software have been and continue to be ported
  586. to the RS/6000. See below for ftp or download information.
  587.  
  588.  
  589. 4.01: How do I find sources?
  590. From: jik@GZA.COM (Jonathan Kamens)
  591.  
  592. There is a newsgroup devoted to posting about how to get a certain
  593. source.  One is strongly urged to follow the guidelines in the article
  594. How_to_find_sources(READ_THIS_BEFORE_POSTING), available via anonymous
  595. ftp from rtfm.mit.edu (18.70.0.209):
  596.  
  597. /pub/usenet/comp.sources.wanted/H_t_f_s_(R_T_B_P)
  598.  
  599. Note: You should try to use hostnames rather than ip addresses since
  600. they are much less likely to change.
  601.  
  602. Also available from mail-server@rtfm.mit.edu by sending a mail
  603. message containing:
  604.  
  605. send usenet/comp.sources.wanted/H_t_f_s_(R_T_B_P)
  606.  
  607. Send a message containing "help" to get general information about the
  608. mail server.
  609.  
  610. If you don't find what you were looking for by following these
  611. guidelines, you can post a message to comp.sources.wanted.
  612.  
  613.  
  614. 4.02: Are there any ftp sites?
  615.  
  616. Below are some ftp sites that are supposed to have RS/6000 specific
  617. software.  I haven't verified all the entries.
  618.  
  619. US sites:
  620. aixpdslib.seas.ucla.edu        128.97.2.211    pub
  621. acd.ucar.edu                128.117.32.1     pub/AIX         
  622. acsc.acsc.com               143.127.0.2        pub
  623. byron.u.washington.edu      128.95.48.32    pub/aix/RS6000 (older stuff)
  624. lightning.gatech.edu        128.61.10.8        pub/aix
  625. tesla.ee.cornell.edu        128.84.253.11    pub
  626.  
  627. European sites:
  628. nic.funet.fi                128.214.6.100    pub/unix/AIX/RS6000
  629. iacrs1.unibe.ch             130.92.11.3        pub
  630. files1zrz.zrz.TU-Berlin.DE  130.149.4.50    pub/aix
  631. ftp-aix.polytechnique.fr    129.104.3.60    pub/binaries/rios
  632. ftp.uni-stuttgart.de        129.69.8.13         sw/rs_aix32/
  633.  
  634. The first one is dedicated to software running on AIX.  It might not
  635. always be the latest versions of the software, but it has been ported to
  636. AIX (normally AIX version 3 only).  Once connected, you should retrieve
  637. the files README and pub/ls-lR.
  638.  
  639. Please use the European sites very sparingly.  They are primarily to
  640. serve people in Europe and most of the software can be found in the US
  641. sites originally.
  642.  
  643. From: reed@prism.sps.mot.com (Tim Reed)
  644.  
  645. Following is a list of possible anonymous ftp sites for information
  646. and programs for the AIX/RS600. Some of the sites were suggested from
  647. other usenet users - those are listed first. The remaining sites were
  648. obtained by a simple search of archie for the names aix, AIX, rs6000
  649. and RS6000. 
  650.  
  651. Sites received from usenet users:
  652.  
  653. Host ibminet.awdpa.ibm.com
  654.     Location: pub/announcements   #IBM announcements
  655.     Location: pub/oemhw           #oem hardware
  656.     Location: pub/ptfs            #PTFs
  657.  
  658. Host cac.toronto.ibm.com
  659.     Location: marketing-info
  660.  
  661. >From David Edelsohn (c1dje@watson.ibm.com):
  662. Host aixpdslib.seas.ucla.edu
  663.     Location: ?                   #AIX archive (sources and binaries)
  664. Host ftp.egr.duke.edu
  665.     Location: ?                   #AIX archive
  666. Host straylight.acs.ncsu.edu
  667.     Location: ?                   #AIX archive
  668. Host alpha.gnu.ai.mit.edu
  669.     Location: /rs6000          #AIX archive
  670.  
  671. >From Frank E. Doss (csfed@ux1.cts.eiu.edu):
  672. Host iacrs2.unibe.ch
  673.     Location: /pub/aix            #bunch of goodies)
  674. Host ftp.u.washington.edu
  675.     Location: /pub/RS6000         #minimal -- ted)
  676. Host aixive.unb.ca
  677.     Location: ?                   #just announced -- new archive)
  678. Host ftp.ans.net
  679.     Location: /pub/misc           #wais goodies)
  680. Host uvaarpa.virginia.edu
  681.     Location: /pub/misc           #minimal -- whois)
  682. Host ux1.cts.eiu.edu
  683.     Location: /pub/rs6000         #minimal -- pop3, FAQ, whois)
  684.  
  685. >From Robert MacKinnon (robmack@bsc.no):
  686. Host ftp.bsc.no
  687.     Location: pub/Src.
  688.  
  689.  
  690. Sites with directories named 'aix':
  691.  
  692. Host aix1.segi.ulg.ac.be   (139.165.32.13)
  693.     Location: /pub/aix
  694.  
  695. Host byron.u.washington.edu   (128.95.48.32)
  696.    Location: /pub/aix
  697.  
  698. Host cunixf.cc.columbia.edu   (128.59.40.130)
  699.     Location: /aix
  700.  
  701. Host files1zrz.zrz.tu-berlin.de   (130.149.4.50)
  702.     Location: /pub/aix
  703.  
  704. Host ftp.rz.uni-augsburg.de   (137.250.113.20)
  705.     Location: /pub/aix
  706.  
  707. Host fyvie.cs.wisc.edu   (128.105.8.18)
  708.     Location: /pub/aix
  709.  
  710. Host solaria.cc.gatech.edu   (130.207.7.245)
  711.     Location: /pub/incoming/aix
  712.     Location: /pub/aix
  713.  
  714. Host spot.colorado.edu   (128.138.129.2)
  715.     Location: /aix
  716.     Location: /pub/patches/aix
  717.  
  718. Host swdsrv.edvz.univie.ac.at   (131.130.1.4)
  719.     Location: /unix/systems/aix
  720.  
  721. Host switek.uni-muenster.de   (128.176.120.210)
  722.     Location: /pub/aix
  723.  
  724. Host wuarchive.wustl.edu   (128.252.135.4)
  725.     Location: /systems/aix
  726.  
  727.  
  728. Sites with directories named 'AIX':
  729.  
  730. Host cs.nyu.edu   (128.122.140.24)
  731.     Location: /pub/AIX
  732.  
  733. Host karazm.math.uh.edu   (129.7.128.1)
  734.     Location: /pub/AIX
  735.  
  736. Host minnie.zdv.uni-mainz.de   (134.93.178.128)
  737.     Location: /pub0/pub/AIX
  738.  
  739. Host oersted.ltf.dth.dk   (129.142.66.16)
  740.     Location: /pub/AIX
  741.  
  742. Host rs3.hrz.th-darmstadt.de   (130.83.55.75)
  743.     Location: /pub/incoming/AIX
  744.  
  745.  
  746. Sites with directories named 'rs6000':
  747.  
  748. Host aeneas.mit.edu   (18.71.0.38)
  749.     Location: /pub/rs6000
  750.  
  751. Host cameron.egr.duke.edu   (128.109.156.10)
  752.     Location: /rs6000
  753.  
  754. Host ifi.informatik.uni-stuttgart.de   (129.69.211.1)
  755.     Location: /pub/rs6000
  756.  
  757. Host metropolis.super.org   (192.31.192.4)
  758.     Location: /pub/rs6000
  759.  
  760. Host ramses.cs.cornell.edu   (128.84.218.75)
  761.     Location: /pub/rs6000
  762.  
  763. Host server.uga.edu   (128.192.1.9)
  764.     Location: /pub/rs6000
  765.  
  766. Host unidata.ucar.edu   (128.117.140.3)
  767.     Location: /pub/bin/rs6000
  768.  
  769. Host uvaarpa.virginia.edu   (128.143.2.7)
  770.     Location: /pub/rs6000
  771.  
  772. Host wayback.cs.cornell.edu   (128.84.254.7)
  773.     Location: /pub/rs6000
  774.  
  775.  
  776. Sites with directories named 'RS6000':
  777.  
  778. Host alice.fmi.uni-passau.de   (132.231.1.180)
  779.     Location: /pub/RS6000
  780.  
  781. Host byron.u.washington.edu   (128.95.48.32)
  782.     Location: /pub/aix/RS6000
  783.  
  784. Host milton.u.washington.edu   (128.95.136.1)
  785.     Location: /pub/RS6000
  786.  
  787. Host pascal.math.yale.edu   (128.36.23.1)
  788.     Location: /pub/RS6000
  789.  
  790. Host uxc.cso.uiuc.edu   (128.174.5.50)
  791.     Location: /pub/RS6000
  792.  
  793.  
  794. 4.03: General hints
  795.  
  796. In general, curses based applications should be linked with -lcurses and
  797. _not_ with -ltermlib.  It has also been reported that compiling with
  798. -DNLS helps curses based programs.
  799.  
  800. Note that the RS/6000 has two install programs, one with System V flavor
  801. in the default PATH (/etc/install with links from /usr/bin and /usr/usg),
  802. and one with BSD behavior in /usr/ucb/install.
  803.  
  804. When adding new shells to the system, add them to the "shells=" line
  805. in /etc/security/login.cfg so they can be used during ftp and rlogin
  806. by users who use them as their default shell.
  807.  
  808.  
  809. 4.04: GNU Emacs
  810.  
  811. Version 18.57 of GNU Emacs started to have RS/6000 support.  Use
  812. s-aix3-2.h for AIX 3.2. Emacs is going through rapid changes recently.
  813. Current release is 19.x.
  814.  
  815. Emacs will core-dump if it is stripped, so don't strip when you install
  816. it.  You can edit a copy of the Makefile in src replacing all 'install -s' 
  817. with /usr/ucb/install.
  818.  
  819.  
  820. 4.05: gcc/gdb
  821.  
  822. GNU C version 2.0 and later supports the RS/6000, and compiles straight
  823. out of the box.  You may, however, experience that compiling it requires
  824. large amounts of paging space.
  825.  
  826. Compiling gcc and gdb requires a patch to the 'as' assembler.  Call
  827. IBM software support and request patch for apar IX26107 (U409205).
  828.  
  829. gcc has undergone many changes lately and the current version is 2.5.x.
  830. gdb is at 4.1x.
  831.  
  832. If your machine crashed when trying to run gdb 4.7, call software support
  833. and request ptf U412815.
  834.  
  835.  
  836. 4.06: GNU Ghostscript
  837.  
  838. The PostScript interpreter GNU Ghostscript Version 2.3 and later supports
  839. the RS/6000 and can be found on various ftp sites. Current version is 2.5.2.
  840.  
  841. 4.07: TeX
  842.  
  843. TeX can be retrieved via ftp from ftp.uni-stuttgart.de.
  844. Be sure to use a recent C compiler (01.02.0000.0013) and you can compile
  845. with optimization.
  846.  
  847.  
  848. 4.08: perl
  849.  
  850. Current version is 4.035 and compiling with cc should give no problems. 
  851. If you use bsdcc, do not use perl's builtin malloc(), edit config.H to
  852. '#define HAS_SYMLINK', and you should be on your way.  Bill Wohler tells
  853. me that perl will run without editing config.H and with cc as well.  So
  854. just say no to use perl's malloc().
  855.  
  856. Doug Sewell <DOUG@YSUB.YSU.EDU> adds:
  857.  
  858. In addition to not using the perl-provided malloc, when asked if you
  859. want to edit config.sh, change 'cppstdin' from the wrapper-program
  860. to '/lib/cpp'.
  861.  
  862. The perl wrapper name is compiled into perl, and requires that you keep
  863. that file in the source directory, even if you blow away the rest of
  864. the source.  /lib/cpp will do the job by itself.  I suspect this will
  865. be fixed in perl 4.0pl11 Configure script.
  866.  
  867. Also, beware if you have gdbm installed per the instructions in the FAQ.
  868. Gdbm is compiled with bsdcc; perl (as I installed it, anyway) was built
  869. with cc, so I used the IBM-provided ndbm routines.
  870.  
  871.  
  872. 4.09: X-Windows
  873.  
  874. IBM has two releases of 3.2.3. The base version has X11R4 and Motif 1.1
  875. and the extended version has X11R5 as AIXwindows 1.2.3.
  876.  
  877. AIXwindows version 1.2.0 (X11rte 1.2.0) is X11R4 with Motif 1.1
  878. AIXwindows version 1.2.3 (X11rte 1.2.3) is X11R5 with Motif 1.1
  879. X11rte.motif1.2 1.2.3 is Motif 1.2 and requires AIXwindows 1.2.3
  880.  
  881.  
  882. 4.10: bash
  883.  
  884. Bash is ported and has some patches on prep.ai.mit.edu. The current
  885. version is 1.13.x and seems to work fine.
  886.  
  887.  
  888. 4.11: Elm
  889.  
  890. A very nice replacement for mail. Elm should be pretty straightforward,
  891. the only thing to remember is to link with -lcurses as the only
  892. curses/termlib library. You may also run into the problem listed under
  893. point 2.13 above.
  894.  
  895.  
  896. 4.12: Oberon 2.2
  897.  
  898. From: afx@muc.ibm.de (Andreas Siegert)
  899.  
  900. Oberon is Wirth's follow on to Modula-2, but is not compatible. A free
  901. version of Modula-3 is available from DEC/Olivetti at
  902. gatekeeper.dec.com. This is not a Modula-2 replacement but a new
  903. language. There are currently two M2 compilers for the 6000 that I know
  904. of. One from Edinburgh Portable Compilers, +44 31 225 6262 (UK) and the
  905. other from Gardens Point compiler +41 65 520311 (Switzerland).
  906.  
  907. Oberon can be obtained via anonymous ftp from neptune.inf.ethz.ch
  908. (129.132.101.33) under the directory Oberon/RS6000 or gatekeeper.dec.com
  909. (16.1.0.2).
  910.  
  911.  
  912. 4.13: Kermit
  913.  
  914. Get it from watsun.cc.columbia.edu (128.59.39.2), kermit/bin/cku189.tar.Z.
  915. Uncompress, untar, and "make rs6000", and it works.
  916.  
  917.  
  918. 4.14: Gnu dbm
  919. From: doug@cc.ysu.edu (Doug Sewell)
  920.  
  921. Here's the fixes for RS/6000's:
  922.  
  923. apply this to testgdbm.c:
  924. 158c158
  925. <   char opt;
  926. ---
  927. >   int opt;
  928. 166c166
  929. <   while ((opt = getopt (argc, argv, "rn")) != -1)
  930. ---
  931. >   while ((opt = getopt (argc, argv, "rn")) != EOF)
  932.  
  933. Apply this to systems.h:
  934. 111a112,114
  935. > #ifdef RS6000
  936. > #pragma alloca
  937. > #else
  938. 112a116
  939. > #endif
  940.  
  941. To compile, edit the Makefile.  Set CC to bsdcc (see /usr/lpp/bos/bsdport
  942. if you don't have 'bsdcc' on your system) and set CFLAGS to -DRS6000 and
  943. whatever options (-g, -O) you prefer.  Don't define SYSV.
  944.  
  945.  
  946. 4.15: tcsh
  947. From: cordes@athos.cs.ua.edu (David Cordes)
  948.  
  949. tcsh is available from tesla.ee.cornell.edu (pub/tcsh-6.00 directory)
  950. Compiles with no problems. You must edit /etc/security/login.cfg to
  951. permit users to change to this shell (chsh), adding the path where the
  952. shell is installed (in my case, /usr/local/bin/tcsh).
  953.  
  954. From: "A. Bryan Curnutt" <bryan@Stoner.COM>
  955.  
  956. Under AIX 3.2.5, you need to modify the "config.h" file, changing
  957.     #define BSDSIGS
  958. to
  959.     #undef BSDSIGS
  960.  
  961.  
  962. 4.16: Kyoto Common Lisp
  963.  
  964. The sources are available from cli.com. The kcl package is the needed
  965. base; also retrieve the latest akcl distribution. akcl provides a
  966. front-end that "ports" the original kcl to a number of different
  967. platforms. The port to the 6000 worked with no problems. However, you
  968. must be root for make to work properly with some memory protection
  969. routines.
  970.  
  971.  
  972. 4.17: Tcl/Tk
  973.  
  974. Current versions: Tcl 7.3, Tk 3.6. Available from sprite.berkeley.edu or
  975. harbor.ecn.purdue.edu.
  976.  
  977.  
  978. 4.18: Expect
  979. From: Doug Sewell <DOUG@YSUB.YSU.EDU>
  980.    
  981. To build the command-interpreter version, you must have the tcl library
  982. built successfully. The expect library doesn't require tcl.  Note:
  983. Expect and its library are built with bsdcc, so applications using
  984. the library probably also need to be developed with bsdcc.
  985.  
  986. I ftp'd expect from ftp.cme.nist.gov.
  987.  
  988. You need to change several lines in the makefile.  First you need
  989. to customize source and target directories and files:
  990. #
  991. TCLHDIR = /usr/include
  992. TCLLIB = -ltcl
  993. MANDIR = /usr/man/manl               (local man-pages)
  994. MANEXT = l
  995. BINDIR = /u/local/bin
  996. LIBDIR = /usr/lib
  997. HDIR = /usr/include
  998. ...
  999. Next set the compiler, switches, and configuration options:
  1000. #
  1001. CC = bsdcc
  1002. CFLAGS = -O
  1003. ...
  1004. PTY_TYPE = bsd
  1005. ...
  1006. INTERACT_TYPE = select
  1007. ...
  1008. Then you need to make these changes about line 90 or so:
  1009. comment out CFLAGS = $(CLFLAGS)
  1010. un-comment these lines:
  1011. CFLAGS = $(CLFLAGS) $(CPPFLAGS)
  1012. LFLAGS = ($CLFLAGS)
  1013.  
  1014. Then run 'make'.
  1015.  
  1016. You can't run some of the examples without modification (host name,
  1017. etc).  I don't remember if I ran all of them or not, but I ran enough
  1018. that I was satisfied it worked.
  1019.  
  1020.  
  1021. 4.19: Public domain software on CD
  1022. From: mbeckman@mbeckman.mbeckman.com (Mel Beckman)
  1023.  
  1024. The Prime Time Freeware CD collection is a package of two CD's and docs
  1025. containing over THREE GIGABYTES of compressed Unix software. It costs $69
  1026. >from Prime Time Freeware, 415-112 N. Mary Ave., Suite 50, Sunnyvale, CA
  1027. 94086. Phone 408-738-4832 voice, 408-738-2050 fax. No internet orders as
  1028. far as I can tell.
  1029.  
  1030. I've extracted and compiled a number of the packages, and all have worked
  1031. flawlessly so far on my 220. Everything from programming languages to 3D
  1032. solid modeling is in this bonanza!
  1033.  
  1034. Ed: The O'Reilly book, Unix Power Tools, also contains a CD-ROM with lots
  1035. of useful programs compiled for the RS/6000, among other platforms.
  1036.  
  1037.  
  1038. 4.20: Andrew Toolkit
  1039.  
  1040. From: Gary Keim <gk5g+@andrew.cmu.edu>
  1041.  
  1042. The Andrew Toolkit Consortium of Carnegie Mellon University's School of
  1043. Computer Science has released new versions of the Andrew User
  1044. Environment, Andrew Toolkit, and Andrew Message System.
  1045.  
  1046. The Andrew User Environment (AUE) is an integrated set of applications
  1047. beginning with a 'generic object' editor, ez, a help system, a system
  1048. monitoring tool (console), an editor-based shell interface (typescript),
  1049. and support for printing multi-media documents. 
  1050.  
  1051. The Andrew Toolkit (ATK) is a portable user-interface toolkit that runs
  1052. under X11. It provides a dynamically-loadable object-oriented
  1053. environment wherein objects can be embedded in one another. Thus, one
  1054. could edit text that, in addition to containing multiple fonts, contains
  1055. embedded raster images, spreadsheets, drawing editors, equations, simple
  1056. animations, etc. These embedded objects can also be nested.
  1057.  
  1058. The Andrew Message System (AMS) provides a multi-media interface to mail
  1059. and bulletin-boards. AMS supports several mail management strategies
  1060. and implements many advanced features including authentication, return
  1061. receipts, automatic sorting of mail, vote collection and tabulation,
  1062. enclosures, audit trails of related messages, and subscription
  1063. management. It has interfaces that support ttys, personal computers, 
  1064. and workstations.
  1065.  
  1066. Release 5.1 of Andrew contains many bug fixes and updates. There is now
  1067. support for the new Internet MIME (Multipurpose Internet Mail Extensions)
  1068. standards for multipart, and multimedia mail. For more information on
  1069. MIME, please see the CHANGES files in the ftp directory on
  1070. emsworth.andrew.cmu.edu.
  1071.  
  1072. This release can be obtained as follows. The sources are available via
  1073. anonymous ftp from export.lcs.mit.edu (18.30.0.238) in the
  1074. ./contrib/andrew tree. For details, see ./contrib/andrew/README.
  1075.  
  1076. PATCH for AIX3.2: A patch to the AUIS 5.1 sources can be ftp'ed from
  1077. emsworth.andrew.cmu.edu (128.2.45.40) in ./aixpatch. For those without
  1078. internet access, a 3.5" diskette can be ordered for a nominal fee of $10
  1079. by sending, or faxing, a purchase order to the Consortium address below.
  1080.  
  1081. Andrew, as well as a variety of other CMU software, can also be ftp'ed
  1082. >from emsworth.andrew.cmu.edu (128.2.30.62). Those with AFS access look
  1083. at /afs/andrew.cmu.edu/itc/sm/releases/X.V11R5/ftp.
  1084.  
  1085. Remote Andrew Demo Service 
  1086.  
  1087. This network service allows you to run Andrew Toolkit applications
  1088. without obtaining or compiling the Andrew software. You need a host
  1089. machine running X11 on the Internet. A simple "finger" command will let
  1090. you experience ATK applications firsthand. You'll be able to compose
  1091. multimedia documents, navigate through the interactive Andrew Tour, and
  1092. use the Andrew Message System to browse through CMU's three thousand
  1093. bulletin boards and newsgroups.
  1094.  
  1095. To use the Remote Andrew Demo service, run the following command:
  1096.  
  1097.     finger help@atk.itc.cmu.edu 
  1098.  
  1099. The service will give you further instructions.
  1100.  
  1101. Information Sources
  1102.  
  1103. Your bug reports are welcome; kindly send them to
  1104. info-andrew-bugs@andrew.cmu.edu and we will periodically post a status
  1105. report to the mailing list info-andrew@andrew.cmu.edu. To be added to
  1106. the mailing list or make other requests, send mail to
  1107. info-andrew-request@andrew.cmu.edu.
  1108.  
  1109. We also distribute the following related materials:
  1110.  
  1111. ATK and AMS sources and binaries on CDROM. Binaries are available
  1112. for the following system types: 
  1113.  
  1114.             IBM RiscSystem/6000 
  1115.         Sun SparcStation 
  1116.         HP 700 Series 
  1117.         DECstation 
  1118.  
  1119. ATK and AMS sources on QIC and Iotamat tapes Hardcopies of the
  1120. documentation for ATK and AMS. Introductory video tape: Welcome to
  1121. Andrew: An Overview of the Andrew System. Technical video tape: The
  1122. Andrew Project: A Session at the Winter 1988 Usenix Conference.
  1123.  
  1124. More information about these materials is available from:
  1125.  
  1126.     Information Requests
  1127.     Andrew Toolkit Consortium
  1128.     Carnegie Mellon University
  1129.     4910 Forbes Avenue, UCC 214
  1130.     Pittsburgh, PA 15213-3890
  1131.     USA
  1132.     phone: +1-412-268-6710
  1133.     fax: +1-412-621-8081
  1134.     info-andrew-request@andrew.cmu.edu
  1135.  
  1136. There is also a netnews distribution list, comp.soft-sys.andrew, which
  1137. is identical to the info-andrew list except that it does not support the
  1138. multi-media capabilities of info-andrew.
  1139.  
  1140.  
  1141. 4.21: sudo
  1142.  
  1143. Allows processes to assume other uids. Version 1.1 (most recent) can be
  1144. obtained from csn.org:/pub/sudo and comprehends AIX.
  1145.  
  1146.  
  1147. 4.22: Flexfax and other fax software
  1148. From: robmack@bsc.no (Rob MacKinnon)
  1149.  
  1150. sgi.com:/sgi/fax to get FlexFax v2.2.1. It supports many types of Class
  1151. 1/2 fax modems and several UNIX systems including AIX 3.2.3 or greater. 
  1152. There is also a fax modem review document at the same site as
  1153. sgi.com:/pub/fax/bakeoff. The FlexFax related files on sgi.com are
  1154. replicated on ftp.bsc.no as well.
  1155.  
  1156. Note: FlexFax 2.4.3 can be ftp'ed from ftp.ee.lbl.gov but I don't know
  1157. if that's an upgrade from the SGI version.
  1158.  
  1159. From: michael@hal6000.thp.Uni-Duisburg.DE (Michael Staats)
  1160.  
  1161. We're using mgetty+sendfax for the basic modem I/O, I wrote a printer
  1162. backend for the modem so that users can send faxes as easy as they print
  1163. postscript. I also wrote a little X interface composer to generate a
  1164. fax form that makes sending faxes very easy. You can find these
  1165. programs at hal6000.thp.Uni-Duisburg.DE under /pub/source.
  1166.  
  1167. program                comment
  1168.  
  1169. mgetty+sendfax-0.14.tar.gz    basic modem I/O, needs hacking for AIX
  1170. X11/xform-1.1.tar.gz             small and simple X interface composer
  1171.                 with an example fax form. Needs
  1172.                 libxview.a incl. headers.
  1173. faxiobe.tar.gz            fax backend, needs configuring for
  1174.                 your local site
  1175.  
  1176. If you need a binary version of libxview.a and the headers you'll find
  1177. them under /pub/binaries/AIX-3-2/lxview.tar.gz.
  1178.  
  1179.  
  1180. 4.23: lsof
  1181. From: abe@vic.cc.purdue.edu (Vic Abell)
  1182.  
  1183. Q. How can I determine the files that a process has opened?
  1184. Q. How can I locate the process that is using a specific network address?
  1185. Q. How can I locate the processes that have files open on a file system?
  1186.  
  1187. A. Use lsof (LiSt Open Files).
  1188.  
  1189. Lsof is available via anonymous ftp from vic.cc.purdue.edu
  1190. (128.210.15.16) in pub/lsofVVVtar.Z where VVV is the version number,
  1191. currently 229.
  1192.  
  1193.  
  1194. 4.24: popper
  1195.  
  1196. The POP server is available via anonymous ftp from ftp.CC.Berkeley.EDU
  1197. (128.32.136.9, 128.32.206.12).  It is in two files in the pub directory:
  1198. a compressed tar file popper-version.tar.Z and a Macintosh StuffIt archive
  1199. in BinHex format called MacPOP.sit.hqx.
  1200.  
  1201. ______________________________________________________________________________
  1202. 5.00: Third party products
  1203.  
  1204. [ Ed.: Entries in this section are edited to prevent them from looking
  1205.   like advertising. Prices given may be obsolete. Companies mentioned
  1206.   are for reference only and are not endorsed in any fashion. ]
  1207.  
  1208.  
  1209. 5.01: IBM list of third party products
  1210. From: marc@sti.com (Marc Pawliger)
  1211.  
  1212. Marc Pawliger post an extensive list periodically to this newsgroup
  1213. about various third party hardware products for the RS/6000. This list
  1214. can also be ftp'd from ibminet.awdpa.ibm.com.
  1215.  
  1216. 3rd Party H/W Guide still there, but no longer maintained, Marc
  1217. Pawliger has left IBM.
  1218.  
  1219. 5.02: Disk/Tape/SCSI
  1220. From: anonymous
  1221.  
  1222. - Most SCSI disk drives work (IBM resells Maxtor, tested Wren 6&7 myself);
  1223.   use osdisk when configuring (other SCSI disk).
  1224.  
  1225. - Exabyte: Unfortunately only the ones IBM sells are working.
  1226.   A few other tape drives will work; 
  1227.   use ostape when configuring (other SCSI tape).
  1228.  
  1229. - STK 3480 "Summit": Works with Microcode Version 5.2b
  1230.  
  1231.  
  1232. From: bell@hops.larc.nasa.gov (John Bell)
  1233.                
  1234. In summary, third party tape drives work fine with the RS/6000 unless 
  1235. you want to boot from them. This is because IBM drives have 'extended 
  1236. tape marks', which IBM claims are needed because the standard marks 
  1237. between files stored on the 8mm tape are unreliable. These extended 
  1238. marks are used when building boot tapes, so when the RS/6000 boots, it 
  1239. searches for an IBM tape drive and refuses to boot without it.
  1240.  
  1241. From: jrogers@wang.com (John Rogers)
  1242.  
  1243. On booting with non-IBM SCSI tape drives: I haven't tried it myself but
  1244. someone offered:
  1245.  
  1246. Turn machine on with key in secure position.
  1247. Wait until LED shows 200 and 8mm tape has stopped loading.
  1248. Turn key to service position.
  1249.  
  1250.  
  1251. From: amelcuk@gibbs.clarku.edu (Andrew Mel'cuk)
  1252.  
  1253. The IBM DAT is cheap and works.  If you get all the patches beforehand
  1254. (U407435, U410140) and remember to buy special "Media Recognition
  1255. System" tapes (Maxell, available from APS 800.443.4461 or IBM #21F8758)
  1256. the drive can even be a pleasure to use.  You can also flip a DIP switch
  1257. on the drive to enable using any computer grade DAT tapes (read the
  1258. hardware service manual).
  1259.  
  1260. Other DAT drives also work.  I have tried the Archive Python (works) and
  1261. experimented extensively with the Archive TurboDAT.  The TurboDAT is a
  1262. very fast compression unit, is not finicky with tapes and doesn't
  1263. require the many patches that the IBM 7206 does.  Works fine with the
  1264. base AIX 3.2 'ost' driver.
  1265.  
  1266.  
  1267. From: pack@acd.ucar.edu (Daniel Packman)
  1268.  
  1269. >>You can boot off of several different brands of non-IBM Exabytes.
  1270. >>At least TTI and Contemporary Cybernetics have done rather complete
  1271. >>jobs of emulating genuine IBM products.
  1272.  
  1273. A model that has worked for us from early AIX 3.1 through 3.2 is a TTI
  1274. CTS 8210.  This is the old low density drive.  The newer 8510 is dual
  1275. density (2.2gig and 5gig).  Twelve dip switches on the back control the
  1276. SCSI address and set up the emulation mode.  These drives have a very
  1277. useful set of lights for read-outs (eg, soft error rate, tape remaining,
  1278. tape motion, etc.).
  1279.  
  1280.  
  1281. 5.03: Memory
  1282.  
  1283. I got a flyer from Nordisk Computer Services (Portland 503-598-0111, 
  1284. Seattle 206-242-7777).  Some sample prices:
  1285.  
  1286.       16 MB Upgrade Kit   $  990
  1287.       32 MB Upgrade Kit   $1,700
  1288.       64 MB Upgrade Kit   $3,300
  1289.  
  1290. 5xx machines have 8 memory slots, 3x0s have 2, and 3x5s have only one.
  1291. You need to add memory in pairs for the 5xx machines.
  1292.  
  1293. Models 220, 230 and 250 can use "PS/2" style SIMM memory.  All have 8
  1294. SIMM sockets.  60ns or better is needed for the 250, 70ns should be OK
  1295. in the 220 and 230.  The 220 and 230 are limited to 64MB of memory,
  1296. the 250 is limited to 256MB.
  1297.  
  1298.  
  1299. 5.04: Others
  1300. From: anonymous
  1301.        
  1302. IBM RISC System/6000 Interface Products
  1303.  
  1304. National Instruments Corporation markets a family of instrumentation
  1305. interface products for the IBM RISC System/6000 workstation family.  The
  1306. interface family consists of three products that give the RISC
  1307. System/6000 connectivity to the standards of VMEbus, VXIbus and GPIB. 
  1308. For more information, contact National Instruments Corporation,
  1309. 512-794-0100 or 1-800-433-3488.
  1310.  
  1311.  
  1312. 5.05: C++ compilers
  1313.  
  1314. Several C++ compilers are available. You can choose from Glockenspiel,
  1315. Greenhills, IBM's xlC (sold seperatly :), and GNU's g++. Glockenspiel
  1316. may now be part of Computer Associates. Comeau Computing
  1317. (718-945-0009) offers Comeau C++ 3.0 with Templates. For a full
  1318. development environment there's ObjectCenter's C++ (formerly Saber
  1319. C++).
  1320.  
  1321.  
  1322. 5.06: Memory leak detectors
  1323.  
  1324. IBM's xlC comes with a product called the HeapView debugger that can
  1325. trace memory problems in C and C++ code.
  1326.  
  1327. SENTINEL has full memory access debugging capabilities including detection 
  1328. of memory leaks.  Contact info@vti.com (800) 296-3000 (703) 430-9247.
  1329.  
  1330. Insight from ParaSoft (818) 792-9941.
  1331. There is also a debug_malloc posted in one of the comp.sources groups.
  1332.  
  1333. From: dad@adonis.az05.bull.com (Dave Dennerline)
  1334.   Purify from Pure software (408) 720-1600.
  1335.   TestCenter from Centerline (800) 669-2687.
  1336. Purify and TestCenter are not availible for the RS/6000 :(
  1337.  
  1338.  
  1339. 5.07: PPP
  1340.  
  1341. PPP does not come with AIX 3.2.x (only SLIP) and there isn't a version
  1342. availible for anonymous ftp.  PPP for AIX is availible for $ from
  1343. Morningstar (sales@morningstar.com or marketing@morningstar.com) (800)
  1344. 558-7872.
  1345.  
  1346. ______________________________________________________________________________
  1347. 6.00: Miscellaneous other stuff
  1348.  
  1349. 6.01: Can I get support by e-mail?
  1350.  
  1351. AIXServ is a service tool that allows users on internet and usenet to
  1352. report problems via unix mail. AIXServ is free. To receive instructions 
  1353. on using AIXServ, send a note with "Subject: package" to one of the
  1354. following e-mail addresses:
  1355.  
  1356.     Internet:   aixbugs%aixserv@uunet.UU.NET
  1357.     Usenet:     uunet.UU.NET!aixserv!aixbugs
  1358.                     aixbugs@austin.ibm.com     (transactions request)
  1359.                     services@austin.ibm.com    (administrivia)
  1360.                     aasc@austin.ibm.com        (test cases under 100KB)
  1361.  
  1362. Using AIXServ, customers have the ability to 1) open new problem reports,
  1363. 2) update existing problem records, and 3) request a status update on an
  1364. existing problem record. Currently this service is available to United
  1365. States customers only.
  1366.  
  1367. Canada:
  1368.  
  1369. Gary Tomic mentioned that Canadian customers can get support from their
  1370. BBS, cac.toronto.ibm.com at 142.77.253.16.
  1371.  
  1372. Germany:
  1373.  
  1374. Thomas Braunbeck reported that German customers with ESS (extended
  1375. software service) contracts can get support by e-mail too. They can 
  1376. obtain information by sending mail with Subject: help to 
  1377. aixcall@aixserv.mainz.ibm.de.
  1378.  
  1379. Various flavors of service offerings are available. Contact your IBM rep
  1380. for details.
  1381.  
  1382.  
  1383. 6.02: List of useful faxes
  1384.  
  1385. You can get some informative faxes by dialing IBM's Faxserver at
  1386. 1-800-IBM-4FAX. If you're calling for the first time, push 3 then 2 to
  1387. request a list of RS/6000 related faxes.
  1388.  
  1389. document number                       Title
  1390. ---------------  -----------------------------------------------------
  1391.      1453        Recovering from LED 518 in AIX 3.2
  1392.      1457        Recovering from LED 552 in AIX 3.1 and 3.2
  1393.      1461        Alternative Problem Reporting Methods
  1394.      1470        Recovering from LED 223/229, 225/229, 233/235, 221/229, or 221
  1395.      1537        How to Get AIX Support
  1396.      1719        Performance Analyzer/6000
  1397.      1721        Recovering from LED 553 in AIX 3.1 and 3.2
  1398.      1746        Recovering from LED 551 in AIX 3.1 and 3.2
  1399.      1755        Recovering Volume Groups
  1400.      1802        Repairing File Systems with fsck in AIX 3.1 and 3.2
  1401.      1803        How to Take a System Dump
  1402.      1804        Setting Up a Modem With the RS/6000
  1403.      1845        Using iptrace to Track Remote Print Jobs
  1404.      1867        Clearing the Queuing System
  1405.      1895        Removing/Replacing a Fixed Disk
  1406.      1896        Tape Drive Densities and Special Files
  1407.      1897        Tips on mksysb for AIX 3.2
  1408.      1909        UUCP (BNU) Helpful Information
  1409.      1910        Synchronizing Disk Names
  1410.      1988        Recovering from LED 201 in AIX 3.1 and 3.2
  1411.      1989        Recovering from LED 727 in AIX 3.2
  1412.      1991        Recovering from LED c31 in AIX 3.1 and 3.2
  1413.      2079        AIX 3.2.4
  1414.      2121        AIX 3.2.4 Installation Tips
  1415.      2267        How to reduce /usr in AIX 3.2
  1416.      2443        Man pages for AIX 3.2
  1417.      2446        How to set up sar
  1418.      2447        How to reduce /tmp
  1419.      2448        Installing a 5 GB tape drive
  1420.      2462        Bosboot diskettes
  1421.      2465        How to remove ptfs from the ODM
  1422.  
  1423.  
  1424. 6.03: List of 3.2 ptfs
  1425.  
  1426. A list of the latest ptfs for 3.2 can be ftp'd from
  1427. ibminet.awdpa.ibm.com but the list is no longer being maintained as of
  1428. 3/14/94.
  1429.  
  1430. 6.04: Some RS232 hints
  1431. From: graeme@ccu1.aukuni.ac.nz, sactoh0.SAC.CA.US!jak
  1432.  
  1433. Q: How do you connect a terminal to the RS232 tty ports when not using
  1434.    the standard IBM cable & terminal transposer?
  1435. A: 1- Connect pins 2->3, 3->2, 7->7 on the DB25's
  1436.    2- On the computer side, most of the time cross 6->20 (DSR, DTR).
  1437.       Some equipment may require connecting 6, 8, and 20 (DSR, DCD, DTR).
  1438.  
  1439. Also, pin 1 (FG) should be a bare metal wire and the cable should be
  1440. shielded with a connection all the way through. Most people don't run
  1441. pin 1 because pins 1 & 7 (SG) are jumpered on many equipment.
  1442.  
  1443. When booting from diskettes, the port speed is always 9600 baud.  If you
  1444. use SMIT to set a higher speed (38400 is nice) for normal use, remember
  1445. to reset your terminal before booting.
  1446.  
  1447. Q: How do you connect a printer to the RS232 tty ports
  1448. A: 1- Connect pins 2->3, 3->2, 7->7 on the DB25's
  1449.    2- On the computer side, loop pins 4->5 (CTS & RTS)
  1450.  
  1451.  
  1452. 6.05  What publications are available for AIX and RS/6000?
  1453.  
  1454. The following are free just for the asking:
  1455.  
  1456. 1. RS/Magazine
  1457.    P.O. Box 3272
  1458.    Lowell, MA 01853-9876
  1459.    e-mail: aknowles@expert.com (Anne Knowles, editor)
  1460.  
  1461. 2. AIXpert
  1462.    IBM Corporation
  1463.    Mail Stop 36
  1464.    472 Wheelers Farms Road
  1465.    Milford, CT 06460
  1466.    FAX: (203) 783-7669
  1467.  
  1468. 3. RiSc World
  1469.    P.O. Box 399
  1470.    Cedar Park, TX 78613
  1471.    FAX: (512) 331-3900
  1472.    Usenet: {cs.utexas.edu,execu,texbell}!pcinews!rsworld
  1473.  
  1474.  
  1475. These manuals should be available from your favorite IBM office.
  1476.  
  1477. SC23-2204-02  Problem Solving Guide
  1478. SC23-2365-01  Performance Monitoring and Tuning Guide for AIX 3.2
  1479. SA23-2629-07  Service Request Number Cross Reference, Ver 2.2
  1480. SA23-2631-05  Diagnostic Programs: Operator Guide
  1481. SA23-2632-05  Diagnostic Programs: Service Guide
  1482. SA23-2643-01  Hardware Technical Reference: General Information
  1483. SA23-2646-01  Hardware Technical Reference: Options and Devices
  1484.  
  1485.  
  1486. 6.06: Some acronyms
  1487.  
  1488. APAR - authorized program analysis report
  1489. BOS  - Basic Operating System
  1490. DCR  - design change request
  1491. LPP  - Licensed Program Product
  1492. ODM  - Object Database Manager
  1493. PRPQ - programming request for price quotation
  1494. PTF  - Program Temporary Fix
  1495. SMIT - System Management Interface Tool
  1496.  
  1497.  
  1498. 6.07: How do I get this by mailserver or ftp?
  1499.  
  1500. Since the articles are crossposted to news.answers, any archive carrying
  1501. that newsgroup will also have these articles. In particular, try
  1502. rtfm.mit.edu in the directory pub/usenet/news.answers. This FAQ is
  1503. archived as "aix-faq/faq/part[1-3]".
  1504.  
  1505.  
  1506. 6.08: Hypertext version of the FAQ
  1507. From: Michael D. Fischer <greendog@max.physics.sunysb.edu>
  1508.  
  1509. Mike has converted this AIX FAQ into HTML code for use from XMosaic or
  1510. other WWW browsers. If you have XMosaic and want to take a look, the URL is
  1511.  
  1512. http://insti.physics.sunysb.edu/faq/index.html
  1513.  
  1514.  
  1515. 6.09: Where can I send suggestions for tools?
  1516.  
  1517. If you have any suggestions or comments about tools, whether currently or 
  1518. desirable to be in AIX, send a note to aix_tool_ideas@austin.ibm.com.
  1519.  
  1520.  
  1521. 6.10: Comp.unix.aix archive availible on the WWW
  1522.  
  1523. Michael Staats & Fred Hucht have informed me that a 
  1524. searchable archive of comp.unix.aix is availible at: 
  1525. http://www.thp.Uni-Duisburg.DE:/cuaix/cuaix.html.
  1526.  
  1527.  
  1528. _____________________________________________________________________________
  1529. 7.00: Contributors
  1530.  
  1531. The following persons have contributed to this list.  If you want to
  1532. contribute anonymously, just let me know - but do tell me who you are.
  1533. I apologise if I missed out anyone.
  1534.  
  1535. Thank you all, this would definitely not be the same without _your_ input.
  1536.  
  1537. Luis Basto            <basto@cactus.org>
  1538. Rudy Chukran            <chukran@austin.VNET.IBM.COM>
  1539. Christopher Carlyle O'Callaghan    <asdfjkl@wam.umd.edu>
  1540. Poul-Henning Kamp        <phk@data.fls.dk>
  1541. Richard Wendland                <richard@praxis.co.uk>
  1542. Ge van Geldorp            <ge@dutlru2.tudelft.nl>
  1543. Chris Jacobsen            <jacobsen@sbhep2.phy.sunysb.edu>
  1544. Peter Jeffe            <peter@ski.austin.ibm.com>
  1545. Jean-Francois Panisset        <panisset@thunder.mcrcim.mcgill.edu>
  1546. John Cary            <cary@boulder.colorado.edu>
  1547. Vijay Debbad            <vijay@ingres.com>
  1548. Dick Karpinski            <dick@ccnext.ucsf.edu>
  1549. Konrad Haedener            <haedener@iac.unibe.ch>
  1550. Doug Sewell            <DOUG@YSUB.YSU.EDU>
  1551. David Cordes            <cordes@athos.cs.ua.edu>
  1552. Graeme Moffat            <g.moffat@aukuni.ac.nz>
  1553. Andrew Pierce            <pierce@claven.cambridge.ibm.com>
  1554. Stephen Linam            <sdl@glasnost.austin.ibm.com>
  1555. Jerome Park            <jerome%aixserv@uunet.UU.NET>
  1556. Konrad Haedener            <haedener@iacrs1.unibe.ch> 
  1557. Steve Roseman            <lusgr@chili.CC.Lehigh.Edu>
  1558. John Burton            <burton@asdsun.larc.nasa.gov>
  1559. Thierry Forveille        <FORVEILL@FRGAG51.BITNET>
  1560. Joubert Berger            <afc-tci!joubert>
  1561. Minh Tran-Le            <tranle@intellicorp.com>
  1562. Paul Amaranth            <amaranth@vela.acs.oakland.edu>
  1563. Mark Whetzel            <markw@airgun.wg.waii.com>
  1564. Daniel Packman            <pack@acd.ucar.edu>
  1565. Ken Bowman            <bowman@uiatma.atmos.uiuc.edu>
  1566. Cary E. Burnette        <kerm@mcnc.org>
  1567. Christophe Wolfhugel        <wolf@grasp1.univ-lyon1.fr>
  1568. Leonard B. Tropiano        <lenny@aixwiz.austin.ibm.com>
  1569. Bill Wohler            <wohler@sap-ag.de>
  1570. James Salter            <jsalter@ibmpa.awdpa.ibm.com>
  1571. Witold Jan Owoc            <witold@enme.ucalgary.ca>
  1572. Marc Kwiatkowski        <marc@ultra.com>
  1573. Ronald S. Woan            <woan@exeter.austin.ibm.com>
  1574. Mijan Huq            <huq@hagar.ph.utexas.edu>
  1575. Herbert van den Bergh        <hbergh@nl.oracle.com>
  1576. Michael Stefanik        <mike@bria.UUCP>
  1577. John F. Haugh            <jfh@rpp386.cactus.org>
  1578. Ed Kubaitis            <ejk@ux2.cso.uiuc.edu>
  1579. Jaime Vazquez            <jaime@austin.vnet.ibm.com>
  1580. Bjorn Engsig            <bengsig@oracle.com>
  1581. Frank Kraemer             <kraemerf@franvm3.VNET.IBM.COM>
  1582. Andreas Siegert                 <afx@muc.ibm.de>
  1583. Thomas Braunbeck                <braunbec@aixserv.mainz.ibm.de>
  1584. Marc Pawliger            <marc@sti.com>
  1585. _____________________________________________________________________________
  1586.  
  1587. Opinions expressed here have nothing to do with IBM.
  1588.  
  1589. All trademarks are the property of their respective owners.
  1590.  
  1591. -- 
  1592. Jeff Warrington
  1593. jwarring@flaixy.fd.amsinc.com  or  a165@lehigh.edu  
  1594.  
  1595.  
  1596.